home *** CD-ROM | disk | FTP | other *** search
/ ADA Programming Guide / ADA Programming Guide.iso / ada_lrm / postscrp.doc < prev    next >
Text File  |  1996-01-30  |  4KB  |  199 lines
  1. The following document is a draft  of  the  corresponding  chapter  of  the
  2. version  21  the  Ada  Reference  Manual  produced  in response to the Ansi
  3. Canvass.  It is given a limited circulation  to  Ada  implementers  and  to
  4. other groups contributing comments (according to the conventions defined in
  5. RRM.comments).  This draft should not be referred to in any publication.
  6.  
  7.  
  8.  
  9. Postscript : Submission of Comments
  10.  
  11.                                  82-12-16
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.                   15. Postscript : Submission of Comments
  73.  
  74.  
  75.  
  76. This  postscript  is  not  part  of  the  standard  definition  of  the Ada
  77. programming language.
  78.  
  79. For submission of comments on this standard Ada reference manual, we  would
  80. appreciate them being sent by Arpanet to the address
  81.  
  82.      Ada-Comment at ECLB
  83.  
  84. If you do not have Arpanet access, please send the comments by mail
  85.  
  86.      Ada Joint Program Office
  87.      Office of the Under Secretary of Defense Research and Engineering
  88.      Washington, DC 20301
  89.      United States of America.
  90.  
  91. For mail comments, it will assist us if you are able to send them on 8-inch
  92. single-sided  single-density  IBM  format  diskette  -  but even if you can
  93. manage this, please also send us a paper copy, in  case  of  problems  with
  94. reading the diskette.
  95.  
  96. All  comments  are  sorted  and processed mechanically in order to simplify
  97. their analysis and to facilitate giving them proper consideration.  To  aid
  98. this  process you are kindly requested to precede each comment with a three
  99. line header
  100.  
  101.           !section ...
  102.           !version 23
  103.           !topic ...
  104.  
  105. The section line includes the section number, the paragraph number enclosed
  106. in parentheses, your name or affiliation (or both), and  the  date  in  ISO
  107. standard  form  (year-month-day).  The paragraph number is the one given in
  108. the margin of the paper form of this document (it is not contained  in  the
  109. ECLB  files);   paragraph  numbers  are  optional, but very helpful.  As an
  110. example, here is the section line of comment #1194 on a  previous  version:
  111.  
  112.           !section 03.02.01(12) D. Taffs 82-04-26
  113.  
  114. The version line, for comments on the current standard, should only contain
  115. "!version  23".   Its  purpose  is  to  distinguish  comments that refer to
  116. different versions.
  117.  
  118. The topic line should contain a one line summary of the comment.  This line
  119. is essential, and you are kindly asked to avoid topics such  as  "Typo"  or
  120. "Editorial comment" which will not convey any information when printed in a
  121. table of contents.  As an example of an informative topic line consider:
  122.  
  123.           !topic Subcomponents of constants are constants
  124.  
  125.  
  126.  
  127.  
  128.                                   15 - 1
  129.  
  130.  
  131.  
  132.  
  133. Note  also  that  nothing  prevents  the  topic line from including all the
  134. information of a comment, as in the following topic line:
  135.  
  136.           !topic Insert:   "...  are  {implicitly}  defined  by  a  subtype
  137.           declaration"
  138.  
  139. As  a  final example here is a complete comment received on a prior version
  140. of this manual:
  141.  
  142.           !section 03.02.01(12) D. Taffs 82-04-26
  143.           !version 10
  144.           !topic Subcomponents of constants are constants
  145.  
  146.           Change "component" to "subcomponent" in the last sentence.
  147.  
  148.           Otherwise the statement is inconsistent with the defined  use  of
  149.           subcomponent  in  3.3, which says that subcomponents are excluded
  150.           when the term component is used instead of subcomponent.
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                   15 - 2
  195.  
  196.  
  197.  
  198.  
  199.